OpenCPort

OpenCPort
Header:	Quickdraw.h		Carbon status:	Unsupported

Allocates space for and initializes a color graphics port.

void OpenCPort (
    CGrafPtr port
);

port: A pointer to a CGrafPort structure.

DISCUSSION

The OpenCPort function is analogous to OpenPort, except that OpenCPort opens a CGrafPort structure instead of a GrafPort structure.

Normally, your application does not need to call this function. The OpenCPort function is called by the NewCWindow and GetNewCWindow functions, as well as by the Dialog Manager when the appropriate color resources are present.

The OpenCPort function allocates storage for all the structures in the CGrafPort structure, and then calls InitCPort to initialize them. The InitCPort function does not allocate a color table for the PixMap structure for the color graphics port; instead, InitCPort copies the handle to the current device’s CLUT into the PixMap structure. The initial values for the CGrafPort structure are:

device

Initial value is 0 (the screen)
portPixMap

Initial value is a handle to the port’s PixMap structure.
portVersion

Initial value is $C000.
grafVersion

Initial values is a handle to a GrafVars structure where black is assigned to the rgbOpColor filed, the default highlight color is assigned to the rgbHiliteColor field, and all other fields are set to 0.
chExtra

Initial value is 0.
pnLocHFrac

Initial value represents the low word of a Fixed number; in decimal, its initial value is 0.5.
portRect

Initial value is screenBits.bound (the boundary for the entire main screen).
visRgn

Initial value is a handle to a rectangular region coincident with screenBits.bounds.
clipRgn

Initial value is a handle to the rectangular region (-32768, -32768, 32767, 32767).
bkPixPat

Initial value is white.
rgbFgColor

Initial value is black.
rgbBkColor

Initial value is white.
pnLoc

Initial value is (0,0).
pnSize

Initial value is (1,1).
pnMode

Initial value is patCopy.
pnPixPat

Initial value is black.
fillPixPat

Initial value is black.
pnVis

Initial value is 0 (visible).
txFont

Initial value is 0 (system font).
txFace

Initial value is plain.
txMode

Initial value is srcOr.
txSize

Initial value is 0 (system font size).
spExtra

Initial value is 0.
fgColor

Initial value is blackColor.
bkColor

Initial value is whiteColor.
colrBit

Initial value is 0.
patStretch

Initial value is 0.
picSave

Initial value is NULL.
rgnSave

Initial value is NULL.
polySave

Initial value is NULL.
grafProcs

Initial value is NULL.

SPECIAL CONSIDERATIONS

The OpenCPort function may move or purge memory blocks in the application heap; do not call this function at interrupt time.

AVAILABILITY

Not supported in Carbon. Not available in CarbonLib, but available when InterfaceLib 7.1 or later is installed. Exported by InterfaceLib 7.1 and later.

CARBON NOTES

Carbon applications should use CreateNewPort and DisposePort to open and close graphics ports.